Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Dialog Box Messages

GXPrintingEvent

QuickDraw GX sends the GXPrintingEvent message when events occur in a print dialog box. You can override the GXPrintingEvent message to handle events such as window update events that occur during display of print dialog boxes. Your override of the GXPrintingEvent message must match the following formal declaration:

OSErr MyPrintingEvent (EventRecord *anEventRecord,
                     Boolean filterEvent);

anEventRecord

A pointer to an event that occurred in a print dialog box.

filterEvent

A Boolean value that is true if the event needs to be filtered, and false if not.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXPrintingEvent message whenever a specific event occurs in one of the print dialog boxes that is displayed for printing. You can override this message if you need to process events that occur during printing.

The default implementation of this message does nothing. Application programs must override this message to correctly support print dialog boxes.

SPECIAL CONSIDERATIONS

You never send the GXPrintingEvent message yourself.

You always create a total override of the GXPrintingEvent message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help